Add Manual Pool State Management and Validator Authentication

Overview

This pull request introduces administrative functionality for manual pool state management and validator authentication within the Predifi application. The changes enable authorized validators to manually update pool states when necessary, providing essential administrative control over pool lifecycle management. Closes #69

Changes Made

New Hooks Added

1. useManuallyUpdatePoolState Hook

• Location: src/app/hooks/useManuallyUpdatePoolState.ts
• Purpose: Provides functionality to manually update pool states
• Key Features:
  • Accepts pool ID and new status parameters
  • Handles wallet and contract availability validation
  • Implements proper error handling and loading states
  • Provides success/error callbacks for flexible integration
  • Uses Starknet's Cairo uint256 for pool ID handling
  • Includes transaction waiting and status verification

2. useValidatorCheck Hook

• Location: src/app/hooks/useValidatorCheck.ts
• Purpose: Validates whether the connected account has validator permissions
• Key Features:
  • Reads validator status from the smart contract
  • Returns loading states for UI feedback
  • Provides account address for reference

Constants Update

• Location: src/constants/functionNames.ts
• Addition: Added MANUALLY_UPDATE_POOL_STATE constant for consistent function name usage

Technical Implementation

Pool State Management

The updatePoolState function handles the complete workflow:

1. Validates wallet connection and contract availability
2. Converts pool ID to Cairo uint256 format
3. Compiles call data using Starknet's CallData utility
4. Executes the transaction through the connected account
5. Waits for transaction confirmation
6. Provides user feedback through toast notifications

Validator Authentication

The validator check hook integrates with the smart contract's is_validator function to determine user permissions, enabling conditional rendering of administrative features.

Error Handling

Both hooks implement comprehensive error handling:

• Network connectivity issues
• Wallet connection problems
• Contract interaction failures
• Transaction execution errors

Dependencies

This implementation relies on:

• @starknet-react/core for blockchain interactions
• starknet library for Cairo utilities
• react-hot-toast for user notifications
• Existing Predifi ABI and contract configurations

Breaking Changes

None. This is an additive change that extends existing functionality without modifying current interfaces.